10.2 查询商户法币订单(OTC代付)
#简要描述: 该接口用于查询商户的法币代付等订单(OTC代付),根据订单号能够查看其订单详情。
- 请求方式: POST
- 请求接口: https://网关域名/wallet-trade-merchant/v1/otc/payment/by-third
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
查询参数
| 参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
|---|---|---|---|---|
| orderId | string | 否 | 平台订单号 | 我方平台订单号或商户本地订单号2选1 |
| localOrderId | string | 否 | 商户本地订单号 | 商户本地订单号或我方平台订单号2选1 |
| key | string | 是 | 商户key | apiKey |
| sign | string | 是 | 签名 | 详情见签名算法 |
请求json样例
{
"key": "9yUreYgTRtit39Dy",
"orderId": 274224939517780,
"sign": "07792d2cf97811d3f2e7bd98edb477e3"
}
返回值
| 参数名称 | 类型 | 参数含义 | 参数说明 |
|---|---|---|---|
| code | int32 | 请求状态 | 返回代码,0为业务成功,否则代表不同的错误 |
| success | boolean | 成功状态 | 成功标识,与code=0一致,用于兼容历史 |
| message | string | 描述 | 错误消息。如果有错误时,返回的错误消息 |
| data | json | 返回数据 | 参数详见下面说明 |
返回示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"merchantId": 302992856974,
"merchantUserId": null,
"orderId": "456290286215493",
"localOrderId": "D19C27AEC95C00297881P",
"status": "SUCCESS",
"currency": "CNY",
"amount": "95",
"notifyTime": 1770192373305,
"orderCreateTime": 1770192298091
}
}
data参数说明
| 参数名称 | 类型 | 参数含义 | 参数说明 |
|---|---|---|---|
| orderId | string | 订单号 | |
| merchantId | int64 | 商户ID | |
| merchantUserId | string | 商户用户ID(商户不传则为null) | |
| localOrderId | string | 订单号 | |
| status | enum | 订单状态 | PROCESSING:处理中| SUCCESS:已完成|FAIL:已失败 |
| currency | string | 订单币种 | |
| amount | string | 订单金额 | |
| orderCreateTime | int64 | 订单创建时间戳 |